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INTRODUCTION | 


This specification describes the format and the initialization of 


the 81800/61700 implementation of relative files» as defined for 
ANSI "74 COBUL. 


FUNCTION 


SYSTEM FILE INITIALIZER CSYSTEM/FILE~INIT)» in some instances» 
allocates tte area used for a relative file and initializes that 
area. This is gescribed in more detail in the paragraphs that 
foltowe | , 


FEATURES 


RELATIVE FILES 


A relative file consists of records identified by relative record 
numbers or "EYs". The file may be thought of as composed of a 
serial string of areas» each capable cf holding a togical record. 
€ach of these areas is addressed by a relative record number. 
For exauple»s the tenth record 1s the one addressed by the 
relative record number tene It is in the tenth record areas 
regardtess of whether records have deen written in the first 
eneouan ene ninth record aredsSe 


These record slots are of fixed tength» the value of which 15 
specified by the file attribute MAXRECSIZE. Each record stot may 
contain one records A record stot is "empty" if it contains no 
valid record. ‘full record stots may be emptied by deleting the 
record they contain» making the contents inaccessadle through the_ 
~norgaal mechanism. CA DELETE verb is implemented in the operating. 
PS Ce avin’ | 'e 3 . 


‘The. record slots are grouped into blocks of one or more records 


and» Like the record size» the nuaber of records per block may 
not oe changed. Appended to and at the begirning of the blocks 
as a field known as the Block Control Information (38Ci). °#£sbCI 


consists of one bit per record stct» flus enough filler bits to 
make the size of the #8CI moduto eight. The dits in the sCI field 
are used to indicate the presence or absence of a valid recerd in 
the associated record slot. A value of one indicates that a 
record is present in. the ;associated slot. SYSTEM/FILESINTT 
allocates the area and initializes all of the necessary presence 
bits» setting them to a value of zero. As a consequence of this 
design» the size of a block in a retative file is equal to the 
number of records per pnlock times the record size plus the 3Cl. 


‘BURRUUGHS CORPURATION 


1°72 


COMPUTER SYSTEMS GROUP SYSTEM FILE INITIALIZER 
SANTA BAREARA PLANT PeSe. 2222 2996 CA) 


INATLALIZATION 


The execution of this program its one means of accomplishing 
Initiatizations however» ultimate responsibility for ensuring 
that areas are initialized lies aith the Master Control Program 
(MCP). | 7 


The manner in which the file is accessed determines the method of 
inatializatton the MCP uses. tf the access mode of the file is 
sequential» the MCP allocates the area andthe lLogicai I/U 
routines initialiyze each block before accesse- In thisS caSe» use 


of SYSTEM/FILE- INIT is not recuired. If the access mode 1s. 
random or dynamice and if a new disk area 1s allocated to the 


files the MCP automatically executes SYSTEM/FILE~INIT to ensure 
that the BCI is initialized. if this is the cases the user 
program which caused the area to be ailocated is stopped ang 
SYSTEM/FILE-INIT i185 executed at the same priority as the 


requesting progran. if aretative file being accessed in the 
sequential mode is closed with the end-of-file CEOF) pointer not 
at the end of an areas the MCP causes the execution of 


SYSTEM/F ILE. INIT to initialize the remainder of that area before 
the CLOSE operation is completed. 


if SYSTEM/FILEsINIT is called by the MCP» as described abovers the 


requesting program is not allowed ~*~ to execute until 


SYSTEM/FILE~INIT has completed the initialization of the area. 
The mechanism used for calling the relative initialization 
program is similar to that used for a program sort. The program 


attempting the write (which requires the use of SYSTEM/FILE.INIT) | 


is hung on its dummy event with tne next queue being the 
S"communicate queuee Upon successful completion of the 
initiatization program- the writing program's dummy event 15 
"caused" and the program goes to the SMCP. The SMCP updates the 


original program's FIB Cfor sequential communicates) before 


passing the communicate to the MHCP for completion of the write. 
If an irrecoverable error is detected during initialization» the 
program is reinstated with standard file status values set in the 
FI of the files upon EUJ or end of task of SYSTEM/FILE-INIT. A 
List of these values is contained in the MCPY1- product 
specifications (Any USE procedures declared for the file will be 
executed at this time. 
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‘OPERATING PROCEDURES 


Uperationalt instructions are not required by the program when it 
is executed automatically by the MCP. Only when initializing the 
file prior to an actual production run is it necessary to provide 
certain information to SYSTEM/FILE.INIT. Users may wish to do 
the tnitializatton prior to the time it is actually required to 
ensure that the required disk space is available and to minimize 
the amount of processing that is actuatly required when a record 


1S added to a new disk area. This flatter consideration might be 
tmportant in an onttine environment where it 1s destraole to 
minimize response time. : 


USER EXECUTION 


Users are responsible for providing file attrisutes for each file 
they want initialized. Attributes may come from one of three 
sources determined by Program Switch 0. These attridutes are 
describea in Table 2.1. Keywords should te used for card or 
operator display terminal (00T) input. File attridutes are set 
by entering keyword *vatue pairs of the form <keyword> = <value>. 
Input is as follows: a TITLE specification followed oy its 
attributes» fotlowed by another TITLE specification and its 
attributes. Input is basically freeform» the only restriction 
being that keyword-value pairs may not ode sptit across record 
bDoundartese See Figure 2-1 for a sample execution. 


TABLE 2.1 FILE ATTRIBUTES 


Attribute 7 Keyword _ | Default 
File name TITLE | none 
Record size RECSIZE® | 175 
| RECURD.SIZE> 
or #82 

Records per = —S RECURDS.BLOCK 1 
block oa or Kef | | 7 
Blocks per area |  BLOCKS.AREA = =—— 100 

or ceA- . 
Number cf.areas AREAS or ARE 25 
File kind FILEKING none 


or FILETYPE 
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2EX SYSTEM/FiLE~ [N1TSSWO 13 
2DATA CARDS — : 
TITLE=MY/FILE2 RECSIZE=80 S8LUCKSIZE=2 
TITLE=MY/FILE3 TITLE=MY/FILE4 AREAS=105 
TITLE=PACKID/MY/FILES 
 « RECSIZE=80 
BLOCKSIZE=2 
AREASIZE=4 
AREAS=105 
FILEKINC=RELATIVE 
2END 


Figure 2.1 Sample of User Execution 


if only one file is to be initialized» a fileequate its proodably 
the easiest means of executing the programe Figure 2.2 depicts a 
sample execution. The. defaults shown in Table 221 apply to any 
attributes not specified in the FILE cards. SWO is defined under 
SWITCH SETTINGS. © | | 


9EX SYSTEM/FILE. INIT SwO O03 
PFI CRELFILE NAME TEST/F1 RECORD. SIZE @0 RECIRDS.BLOCK 19 
2ELUCKS AREA 10 FILE.TYPE=RELATIVES % AREAS DEFAULT TO 25 


Figure 2.2 Sampte Execution for a Single Fite 


HCP INTERNAL USE 


When the MCP automatically executes the program» it passes three 
pieces of information to the initialization program via ae fite 
equation to RELFILE. The string that performs the catl (Csee 
section on intitialization) is: | | 


?EX SYSTEM/FILE.* INIT SW9 13F1 RELFILE NAM <file name> AREAS <area #>3 
The three pieces of information are: 


= the file name 

“~ the area to be initialized 

- the MCP request that only one area 1s to de initialized 
Cindicated by Program Switch 9 set to a nonzero integer 
as shown in the string above). 
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SWITCH SETTINGS 
Program Switch 0O determines the source of tile attricSutes. 
SWO 0 indicates the source 1s a file equation to PELFILE. 
SHO 1 indicates the source is carc input. 
SWO 2715 indicates the source is UDT input. 
Prograa Switch 9» set to any nonzero numbers specifies that the 
program was initiated automatically by the MCP; that only one 
area is to be initialized and that the file is a relative file. 


This switch is reserved for use by the MCP and users are 
prohibited from setting ite : | 


Sa n 
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ERROR MESSAGES 


When the program is executed automatically ty the NCP» error 
messages are not displayed; however» three conditions might de 


/ returned to the cathe programe 


Ll. The file is not present on disk. 
2- The file is locked Cuy some. other program). 
3e An irrecoverable 1/0 error occurred or initialization. 


These canditions are stored in the file status variable for the 
appropriate file. The calling program may take action based on 
these conditions. The first two conditions are unlikely to occur 
by virtue of the fact that the calling program is either creating 
the file Cin the case of a new file)» or accessing an existing 
fite. The third condition is more tikely tc occurs in which 
cases the calling program should d3e prepared to handie the 
difference or be discontinued. 


When the program is executed from the ODT or from the card 
readers the totlawing error messages are subject to display. 


INVALID <token name> -~<vatue> 
The’ name of: the token entered was a valid attribute name Dut > 
the value associated with it exceeded the MCP*s Limits on 
that attribute. The values allowed for the relevant 
acerouces are presented in the Scftware Uperational Guides 


INVALID TOKEN --<name> | | | 
The attribute specifted Dy <name> is not recognizatle by the 
program. ee | | | 


EQUAL SIGN EXPECTED | 
The equal sign between the attribute and its value is 
Bandatorye ; | | 


VALUE. EXPECTED AFTER = 7 7 

No value was found in the input string after the equal sign 
in an attribute specification. When the input is from 
cards» the attribute value must-be contained on the same 
card as the attribute NaMmee 


UNEXPECTED TOKEN --<nase> “-TITLE EXPECTED | 
The pregramw was tooking for a TITLE attribute and 
encountered a different attribute name e | 
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<file name> NOT INITIALIZED FILE MISSING 
<fiie name> NOT INITIALIZED FILE LOCKED 
<file name> NOT INITIALIZED EXCEPTION ON WRITE | 
The fite was not initialized due to the cause displayed. 
The first two messages cannot occur «hen the program is 
executed from the OOT or from the card reader because tn 
these caseSe the program always creates a new files thus» 
the program cannot he used to initialize one area of an 
existing file. i. | 
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RELFILE ~JQisk file 


CAKOS | Card fite 


RECORD SLOTS ini 
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